~ chicken-core (master) /manual/Module (scheme write)
Trap1[[tags: manual]]2[[toc:]]34== Module (scheme write)56If port is omitted from any output procedure, it defaults to the value returned by7(current-output-port). It is an error to attempt an output operation on a8closed port.910<procedure>(write obj [port9])</procedure>1112Writes a representation of obj to the given textual output13port. Strings that appear in the written representation are enclosed in14quotation marks, and within those strings backslash and quotation mark15characters are escaped by backslashes. Symbols that contain non-ASCII16characters are escaped with vertical lines. Character objects are written using17the #\ notation.1819If obj contains cycles which would cause an infinite loop using the normal written20representation, then at least the objects that form part of the cycle must be21represented using datum labels. Datum labels are22not be used if there are no cycles.2324The write procedure returns an unspecified value.2526<procedure>(write-shared obj [port])</procedure>2728The write-shared procedure is the same as write, except that shared structure29must be represented using datum labels for all pairs and vectors that appear30more than once in the output.3132<procedure>(write-simple obj [port])</procedure>3334The write-simple procedure is the same as write, except that shared structure35is never represented using datum labels. This can cause write-simple not to36terminate if37obj contains circular structure.3839<procedure>(display obj [port])</procedure>4041Writes a representation of42obj to the given textual output43port. Strings that appear in the written representation are output as if by44write-string instead of by write. Symbols are not escaped. Character objects45appear in the representation as if written by write-char instead of by write.4647The display representation of other objects is unspecified. However, display48must not loop forever on self-referencing pairs, vectors, or records. Thus if49the normal write representation is used, datum labels are needed to represent50cycles as in write.5152The display procedure returns an unspecified value.5354Rationale: The write procedure is intended for producing machine-readable55output and display for producing human-readable output.5657---58Previous: [[Module (scheme time)]]5960Next: [[Module (chicken base)]]